home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / remote / race150.zip / RACEEDIT.DOC < prev    next >
Text File  |  1991-11-02  |  6KB  |  114 lines

  1.  
  2.                           RACEEDIT.EXE
  3.  
  4. RACEEDIT is a simple full screen editor that will allow you to write a
  5. message to a user from within RACE.  RACEEDIT does not have block
  6. commands or search and replace or any other fancy do-dads.  It's
  7. a basic editor that will allow you to write a quick message to a
  8. user.  If you would like to use your own editor, see the technical
  9. notes in the second half of this document.
  10.  
  11. Place RACEEDIT.EXE in the same directory as RACE.EXE.  From within the
  12. RACE main screen, press ALT-E to bring up the message editor.  If you
  13. are a registered RACE user, ALT-E will also bring up the editor in the
  14. validation screen.  If you are not registered, "Unavailable in
  15. unregistered version" is displayed if you press ALT-E in validate.
  16.  
  17. RACEEDIT is executed directly from with RACE and command.com is not
  18. used.  Whether or not RACE swaps out before running RACEEDIT is
  19. determined by your settings for Swap file in RACECFG.  See RACE.DOC for
  20. full information on the swap file set up.
  21.  
  22. RACEEDIT gets most of the message header information from the welcome
  23. message configuration set up in RACECFG.  The TO: field is filled with
  24. the name of the user currently being viewed in the main screen or in
  25. validate mode if registered as previously mentioned.
  26.  
  27. The lack of ability to edit header information was a design decision
  28. meant to prevent accidental posting of messages to non-existant users,
  29. in message boards where they shouldn't go (echomail), undefined boards,
  30. etc.  The primary purpose of the built in editor is for use during
  31. validation and so using the welcome message set up information was felt
  32. to be the best and safest way to go.
  33.  
  34. RACEEDIT will allow creation of a message up to 64k in length or
  35. available memory, whichever is the lesser of the two.
  36.  
  37.  
  38. Technical information
  39. ---------------------
  40.  
  41. RACEEDIT.EXE is basically a Turbo Professional TpMemo editor that was
  42. written specifically to work with RACE.
  43.  
  44. You CANNOT simply rename your favorite editor to RACEEDIT.EXE and use it
  45. in place of the supplied editor.  This was not done intentionally to
  46. prevent using a different editor.  One reason for this is that the best
  47. method of determining what RACE should do next on return from running the
  48. editor is by examining the errorlevel the editor has dropped.  Most
  49. editors don't drop an errorlevel upon exit and if they do, they probably
  50. won't match what RACE needs to know.  The following errorlevels are
  51. defined in RACEEDIT.EXE:
  52.  
  53.       0 = normal termination, message text saved
  54.       1 = normal termination, message text NOT saved
  55.       2 = window error (probably insufficient heap space)
  56.       3 = error writing message file
  57.       4 = error reading message file
  58.       5 = buffer allocation or memory error
  59.  
  60. The first two errorlevels are obviously the most important and if you
  61. have an editor that can drop those under the proper conditions, you MAY
  62. be able to use it in place of RACEEDIT.  Note that most editors will
  63. probably (?) return an errorlevel of 0 no matter what happens short of
  64. the editor crashing.  If that is the case, RACE may attempt to import
  65. the text file even if you aborted the save in your editor.  More on this
  66. later.
  67.  
  68. The next thing you need to know is that RACEEDIT writes any saved text
  69. to a file called RACETMP.MSG.  This is the filename RACE will look for
  70. if an errorlevel of 0 is returned when exiting the editor.  Once this
  71. file is successfully imported, RACE deletes it.
  72.  
  73. Another thing to keep in mind is that RACEEDIT saves the underlying
  74. screen before it pops up and restores it upon exit.  If your editor
  75. doesn't do this, it could get messy looking.
  76.  
  77. I have tested RACE with Qedit by renaming Qedit.exe to RACEEDIT.EXE and
  78. it does work for the most part.  Even though RACEEDIT does not need the
  79. text file name passed to it, RACE passes 'RACETMP.MSG' for the use
  80. of other editors.  By providing this, you won't have to answer your
  81. editor's prompt for a filename everytime you want to write a message.
  82.  
  83. You will probably need the registered version of Qedit because I believe
  84. the unregistered version does not save the underlying screen.  Although
  85. RACE updates all the information after any action, it does NOT redraw
  86. the entire screen and as mentioned before, it might not be pretty if
  87. your editor doesn't save the screen.
  88.  
  89. Next you will need to rename QEDIT.EXE to RACEEDIT.EXE and place it in
  90. the same directory as RACE.  Future versions of RACE may allow you to
  91. define the editor name, but for now "RACEEDIT.EXE" is hard coded into
  92. RACE.
  93.  
  94. When using Qedit with RACE =YOU= will have to be sure you don't save
  95. any text if you wish to abort the message.  QEDIT will not create
  96. RACETMP.MSG until you save or save and exit so RACE will be able to
  97. tell there is nothing to import if you leave Qedit properly.
  98.  
  99. Since Qedit doesn't drop the same (or any?) errorlevels as the real
  100. RACEEDIT, the only way RACE can tell the message was aborted is by the
  101. absence of RACETMP.MSG.  If it finds this file it =WILL= import it if
  102. you are using an editor other than the 'official' RACEEDIT.
  103.  
  104. Last but not least, you will have to insure the margins within Qedit are
  105. reasonable.  RACE imports the message text as is with absolutely NO
  106. formatting.  Set your right margin to 65 or 70 and all should be fine.
  107.  
  108. The above procedures may or may not work with other editors.  You'll
  109. just have to experiment a bit.
  110.  
  111.  
  112.                                 ** EOF **
  113.  
  114.